home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cato / Xm / XmCascadeButton.z / XmCascadeButton
Encoding:
Text File  |  2002-10-03  |  33.8 KB  |  529 lines

  1.  
  2.  
  3.  
  4.      XXXXmmmmCCCCaaaassssccccaaaaddddeeeeBBBBuuuuttttttttoooonnnn((((3333XXXX))))       UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV       XXXXmmmmCCCCaaaassssccccaaaaddddeeeeBBBBuuuuttttttttoooonnnn((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XXXXmmmmCCCCaaaassssccccaaaaddddeeeeBBBBuuuuttttttttoooonnnn - The CascadeButton widget class
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.           ####iiiinnnncccclllluuuuddddeeee <<<<XXXXmmmm////CCCCaaaassssccccaaaaddddeeeeBBBB....hhhh>>>>
  13.  
  14.  
  15.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  16.           This page documents version 1.2 of the Motif library.
  17.  
  18.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  19.           CascadeButton links two MenuPanes or a MenuBar to a
  20.           MenuPane.
  21.  
  22.           It is used in menu systems and must have a RowColumn parent
  23.           with its XXXXmmmmNNNNrrrroooowwwwCCCCoooolllluuuummmmnnnnTTTTyyyyppppeeee resource set to XXXXmmmmMMMMEEEENNNNUUUU____BBBBAAAARRRR,
  24.           XXXXmmmmMMMMEEEENNNNUUUU____PPPPOOOOPPPPUUUUPPPP or XXXXmmmmMMMMEEEENNNNUUUU____PPPPUUUULLLLLLLLDDDDOOOOWWWWNNNN.
  25.  
  26.           It is the only widget that can have a Pulldown MenuPane
  27.           attached to it as a submenu.  The submenu is displayed when
  28.           this widget is activated within a MenuBar, a PopupMenu, or a
  29.           PulldownMenu.  Its visuals can include a label or pixmap and
  30.           a cascading indicator when it is in a Popup or Pulldown
  31.           MenuPane; or, it can include only a label or a pixmap when
  32.           it is in a MenuBar.
  33.  
  34.           The default behavior associated with a CascadeButton depends
  35.           on the type of menu system in which it resides.  By default,
  36.           BBBBSSSSeeeelllleeeecccctttt controls the behavior of the CascadeButton.  In
  37.           addition, BBBBMMMMeeeennnnuuuu controls the behavior of the CascadeButton
  38.           if it resides in a PopupMenu system.  The actual mouse
  39.           button used is determined by its RowColumn parent.
  40.  
  41.           A CascadeButton's visuals differ from most other button
  42.           gadgets.  When the button becomes armed, its visuals change
  43.           from a 2-D to a 3-D look, and it displays the submenu that
  44.           has been attached to it.  If no submenu is attached, it
  45.           simply changes its visuals.
  46.  
  47.           When a CascadeButton within a Pulldown or Popup MenuPane is
  48.           armed as the result of the user moving the mouse pointer
  49.           into the widget, it does not immediately display its
  50.           submenu.  Instead, it waits a short amount of time to see if
  51.           the arming was temporary (that is, the user was simply
  52.           passing through the widget), or whether the user really
  53.           wanted the submenu posted.  This time delay is configurable
  54.           via XXXXmmmmNNNNmmmmaaaappppppppiiiinnnnggggDDDDeeeellllaaaayyyy.
  55.  
  56.           CascadeButton provides a single mechanism for activating the
  57.           widget from the keyboard.  This mechanism is referred to as
  58.           a keyboard mnemonic.  If a mnemonic has been specified for
  59.           the widget, the user may activate the CascadeButton by
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 4/30/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXmmmmCCCCaaaassssccccaaaaddddeeeeBBBBuuuuttttttttoooonnnn((((3333XXXX))))       UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV       XXXXmmmmCCCCaaaassssccccaaaaddddeeeeBBBBuuuuttttttttoooonnnn((((3333XXXX))))
  71.  
  72.  
  73.  
  74.           simply typing the mnemonic while the CascadeButton is
  75.           visible.  If the CascadeButton is in a MenuBar and the
  76.           MenuBar does not have the focus, the MMMMAAAAlllltttt modifier must be
  77.           pressed with the mnemonic.  Mnemonics are typically used to
  78.           interact with a menu via the keyboard interface.
  79.  
  80.           If in a Pulldown or Popup MenuPane and there is a submenu
  81.           attached, the XXXXmmmmNNNNmmmmaaaarrrrggggiiiinnnnBBBBoooottttttttoooommmm, XXXXmmmmNNNNmmmmaaaarrrrggggiiiinnnnLLLLeeeefffftttt,
  82.           XXXXmmmmNNNNmmmmaaaarrrrggggiiiinnnnRRRRiiiigggghhhhtttt, and XXXXmmmmNNNNmmmmaaaarrrrggggiiiinnnnTTTToooopppp resources may enlarge to
  83.           accommodate XXXXmmmmNNNNccccaaaassssccccaaaaddddeeeePPPPiiiixxxxmmmmaaaapppp.  XXXXmmmmNNNNmmmmaaaarrrrggggiiiinnnnWWWWiiiiddddtttthhhh defaults to 6
  84.           if this resource is in a MenuBar; otherwise, it takes
  85.           Label's default, which is 2.
  86.  
  87.         CCCCllllaaaasssssssseeeessss
  88.           CascadeButton inherits behavior and resources from CCCCoooorrrreeee,
  89.           XXXXmmmmPPPPrrrriiiimmmmiiiittttiiiivvvveeee, and XXXXmmmmLLLLaaaabbbbeeeellll classes.
  90.  
  91.           The class pointer is xxxxmmmmCCCCaaaassssccccaaaaddddeeeeBBBBuuuuttttttttoooonnnnWWWWiiiiddddggggeeeettttCCCCllllaaaassssssss.
  92.  
  93.           The class name is XXXXmmmmCCCCaaaassssccccaaaaddddeeeeBBBBuuuuttttttttoooonnnn.
  94.  
  95.         NNNNeeeewwww RRRReeeessssoooouuuurrrrcccceeeessss
  96.           The following table defines a set of widget resources used
  97.           by the programmer to specify data.  The programmer can also
  98.           set the resource values for the inherited classes to set
  99.           attributes for this widget.  To reference a resource by name
  100.           or by class in a .Xdefaults file, remove the XXXXmmmmNNNN or XXXXmmmmCCCC
  101.           prefix and use the remaining letters.  To specify one of the
  102.           defined values for a resource in a .Xdefaults file, remove
  103.           the XXXXmmmm prefix and use the remaining letters (in either
  104.           lowercase or uppercase, but include any underscores between
  105.           words).  The codes in the access column indicate if the
  106.           given resource can be set at creation time (C), set by using
  107.           XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss (S), retrieved by using XXXXttttGGGGeeeettttVVVVaaaalllluuuueeeessss (G), or is
  108.           not applicable (N/A).
  109.  
  110.                             XXXXmmmmCCCCaaaassssccccaaaaddddeeeeBBBBuuuuttttttttoooonnnn RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  111.      NNNNaaaammmmeeee                   CCCCllllaaaassssssss             TTTTyyyyppppeeee             DDDDeeeeffffaaaauuuulllltttt   AAAAcccccccceeeessssssss
  112.      __________________________________________________________________________
  113.      XmNactivateCallback    XmCCallback       XtCallbackList   NULL      C
  114.      XmNcascadePixmap       XmCPixmap         Pixmap           dynamic   CSG
  115.      XmNcascadingCallback   XmCCallback       XtCallbackList   NULL      C
  116.      XmNmappingDelay        XmCMappingDelay   int              180 ms    CSG
  117.      XmNsubMenuId           XmCMenuWidget     Widget           NULL      CSG
  118.  
  119.  
  120.           XXXXmmmmNNNNaaaaccccttttiiiivvvvaaaatttteeeeCCCCaaaallllllllbbbbaaaacccckkkk
  121.                     Specifies the list of callbacks that is called
  122.                     when the user activates the CascadeButton widget,
  123.                     and there is no submenu attached to pop up.  The
  124.                     activation occurs by releasing a mouse button or
  125.                     by typing the mnemonic associated with the widget.
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 4/30/98)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      XXXXmmmmCCCCaaaassssccccaaaaddddeeeeBBBBuuuuttttttttoooonnnn((((3333XXXX))))       UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV       XXXXmmmmCCCCaaaassssccccaaaaddddeeeeBBBBuuuuttttttttoooonnnn((((3333XXXX))))
  137.  
  138.  
  139.  
  140.                     The specific mouse button depends on information
  141.                     in the RowColumn parent.  The reason sent by the
  142.                     callback is XXXXmmmmCCCCRRRR____AAAACCCCTTTTIIIIVVVVAAAATTTTEEEE.
  143.  
  144.           XXXXmmmmNNNNccccaaaassssccccaaaaddddeeeePPPPiiiixxxxmmmmaaaapppp
  145.                     Specifies the cascade pixmap displayed on one end
  146.                     of the widget when a CascadeButton is used within
  147.                     a Popup or Pulldown MenuPane and a submenu is
  148.                     attached.  The Label class resources
  149.                     XXXXmmmmNNNNmmmmaaaarrrrggggiiiinnnnBBBBoooottttttttoooommmm, XXXXmmmmNNNNmmmmaaaarrrrggggiiiinnnnLLLLeeeefffftttt, XXXXmmmmNNNNmmmmaaaarrrrggggiiiinnnnRRRRiiiigggghhhhtttt,
  150.                     and XXXXmmmmNNNNmmmmaaaarrrrggggiiiinnnnTTTToooopppp may be modified to ensure that
  151.                     room is left for the cascade pixmap.  The default
  152.                     cascade pixmap is an arrow pointing to the side of
  153.                     the menu where the submenu will appear.
  154.  
  155.           XXXXmmmmNNNNccccaaaassssccccaaaaddddiiiinnnnggggCCCCaaaallllllllbbbbaaaacccckkkk
  156.                     Specifies the list of callbacks that is called
  157.                     just prior to the mapping of the submenu
  158.                     associated with CascadeButton.  The reason sent by
  159.                     the callback is XXXXmmmmCCCCRRRR____CCCCAAAASSSSCCCCAAAADDDDIIIINNNNGGGG.
  160.  
  161.           XXXXmmmmNNNNmmmmaaaappppppppiiiinnnnggggDDDDeeeellllaaaayyyy
  162.                     Specifies the amount of time, in milliseconds,
  163.                     between when a CascadeButton becomes armed and
  164.                     when it maps its submenu.  This delay is used only
  165.                     when the widget is within a Popup or Pulldown
  166.                     MenuPane.  The value must not be negative.
  167.  
  168.           XXXXmmmmNNNNssssuuuubbbbMMMMeeeennnnuuuuIIIIdddd
  169.                     Specifies the widget ID for the Pulldown MenuPane
  170.                     to be associated with this CascadeButton.  The
  171.                     specified MenuPane is displayed when the
  172.                     CascadeButton becomes armed.  The MenuPane must
  173.                     have been created with the appropriate parentage
  174.                     depending on the type of menu used.  See
  175.                     XXXXmmmmCCCCrrrreeeeaaaatttteeeeMMMMeeeennnnuuuuBBBBaaaarrrr((((3333XXXX)))), XXXXmmmmCCCCrrrreeeeaaaatttteeeePPPPuuuullllllllddddoooowwwwnnnnMMMMeeeennnnuuuu((((3333XXXX)))), and
  176.                     XXXXmmmmCCCCrrrreeeeaaaatttteeeePPPPooooppppuuuuppppMMMMeeeennnnuuuu((((3333XXXX)))) for more information on the
  177.                     menu systems.
  178.  
  179.  
  180.         IIIInnnnhhhheeeerrrriiiitttteeeedddd RRRReeeessssoooouuuurrrrcccceeeessss
  181.           CascadeButton inherits behavior and resources from the
  182.           following superclasses.  For a complete description of each
  183.           resource, refer to the man page for that superclass.
  184.  
  185.                                                 XXXXmmmmLLLLaaaabbbbeeeellll RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  186.      NNNNaaaammmmeeee                        CCCCllllaaaassssssss                       TTTTyyyyppppeeee                DDDDeeeeffffaaaauuuulllltttt                  AAAAcccccccceeeessssssss
  187.      ___________________________________________________________________________________________________________
  188.      XmNaccelerator              XmCAccelerator              String              NULL                     N/A
  189.      XmNacceleratorText          XmCAcceleratorText          XmString            NULL                     N/A
  190.  
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                                          (printed 4/30/98)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      XXXXmmmmCCCCaaaassssccccaaaaddddeeeeBBBBuuuuttttttttoooonnnn((((3333XXXX))))       UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV       XXXXmmmmCCCCaaaassssccccaaaaddddeeeeBBBBuuuuttttttttoooonnnn((((3333XXXX))))
  203.  
  204.  
  205.  
  206.      XmNalignment                XmCAlignment                unsigned char       dynamic                  CSG
  207.      XmNfontList                 XmCFontList                 XmFontList          dynamic                  CSG
  208.      XmNlabelInsensitivePixmap   XmCLabelInsensitivePixmap   Pixmap              XmUNSPECIFIED_PIXMAP     CSG
  209.      XmNlabelPixmap              XmCLabelPixmap              Pixmap              XmUNSPECIFIED_PIXMAP     CSG
  210.      XmNlabelString              XmCXmString                 XmString            dynamic                  CSG
  211.      XmNlabelType                XmCLabelType                unsigned char       XmSTRING                 CSG
  212.      XmNmarginBottom             XmCMarginBottom             Dimension           dynamic                  CSG
  213.      XmNmarginHeight             XmCMarginHeight             Dimension           2                        CSG
  214.      XmNmarginLeft               XmCMarginLeft               Dimension           0                        CSG
  215.      XmNmarginRight              XmCMarginRight              Dimension           dynamic                  CSG
  216.      XmNmarginTop                XmCMarginTop                Dimension           dynamic                  CSG
  217.      XmNmarginWidth              XmCMarginWidth              Dimension           dynamic                  CSG
  218.      XmNmnemonic                 XmCMnemonic                 KeySym              NULL                     CSG
  219.      XmNmnemonicCharSet          XmCMnemonicCharSet          String              XmFONTLIST_DEFAULT_TAG   CSG
  220.      XmNrecomputeSize            XmCRecomputeSize            Boolean             True                     CSG
  221.      XmNstringDirection          XmCStringDirection          XmStringDirection   dynamic                  CSG
  222.  
  223.                                          XXXXmmmmPPPPrrrriiiimmmmiiiittttiiiivvvveeee RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  224.      NNNNaaaammmmeeee                    CCCCllllaaaassssssss                   TTTTyyyyppppeeee               DDDDeeeeffffaaaauuuulllltttt                AAAAcccccccceeeessssssss
  225.      ________________________________________________________________________________________________
  226.      XmNbottomShadowColor    XmCBottomShadowColor    Pixel              dynamic                CSG
  227.      XmNbottomShadowPixmap   XmCBottomShadowPixmap   Pixmap             XmUNSPECIFIED_PIXMAP   CSG
  228.      XmNforeground           XmCForeground           Pixel              dynamic                CSG
  229.      XmNhelpCallback         XmCCallback             XtCallbackList     NULL                   C
  230.      XmNhighlightColor       XmCHighlightColor       Pixel              dynamic                CSG
  231.      XmNhighlightOnEnter     XmCHighlightOnEnter     Boolean            False                  CSG
  232.      XmNhighlightPixmap      XmCHighlightPixmap      Pixmap             dynamic                CSG
  233.      XmNhighlightThickness   XmCHighlightThickness   Dimension          0                      CSG
  234.      XmNnavigationType       XmCNavigationType       XmNavigationType   XmNONE                 CSG
  235.      XmNshadowThickness      XmCShadowThickness      Dimension          2                      CSG
  236.      XmNtopShadowColor       XmCTopShadowColor       Pixel              dynamic                CSG
  237.      XmNtopShadowPixmap      XmCTopShadowPixmap      Pixmap             dynamic                CSG
  238.      XmNtraversalOn          XmCTraversalOn          Boolean            dynamic                G
  239.      XmNunitType             XmCUnitType             unsigned char      dynamic                CSG
  240.      XmNuserData             XmCUserData             XtPointer          NULL                   CSG
  241.  
  242.                                                    CCCCoooorrrreeee RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  243.      NNNNaaaammmmeeee                            CCCCllllaaaassssssss                           TTTTyyyyppppeeee             DDDDeeeeffffaaaauuuulllltttt                AAAAcccccccceeeessssssss
  244.      ______________________________________________________________________________________________________________
  245.      XmNaccelerators                 XmCAccelerators                 XtAccelerators   dynamic                CSG
  246.      XmNancestorSensitive            XmCSensitive                    Boolean          dynamic                G
  247.      XmNbackground                   XmCBackground                   Pixel            dynamic                CSG
  248.      XmNbackgroundPixmap             XmCPixmap                       Pixmap           XmUNSPECIFIED_PIXMAP   CSG
  249.      XmNborderColor                  XmCBorderColor                  Pixel            XtDefaultForeground    CSG
  250.      XmNborderPixmap                 XmCPixmap                       Pixmap           XmUNSPECIFIED_PIXMAP   CSG
  251.      XmNborderWidth                  XmCBorderWidth                  Dimension        0                      CSG
  252.      XmNcolormap                     XmCColormap                     Colormap         dynamic                CG
  253.      XmNdepth                        XmCDepth                        int              dynamic                CG
  254.      XmNdestroyCallback              XmCCallback                     XtCallbackList   NULL                   C
  255.      XmNheight                       XmCHeight                       Dimension        dynamic                CSG
  256.  
  257.  
  258.  
  259.  
  260.  
  261.      Page 4                                          (printed 4/30/98)
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.      XXXXmmmmCCCCaaaassssccccaaaaddddeeeeBBBBuuuuttttttttoooonnnn((((3333XXXX))))       UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV       XXXXmmmmCCCCaaaassssccccaaaaddddeeeeBBBBuuuuttttttttoooonnnn((((3333XXXX))))
  269.  
  270.  
  271.  
  272.      XmNinitialResourcesPersistent   XmCInitialResourcesPersistent   Boolean          True                   C
  273.      XmNmappedWhenManaged            XmCMappedWhenManaged            Boolean          True                   CSG
  274.      XmNscreen                       XmCScreen                       Screen *         dynamic                CG
  275.      XmNsensitive                    XmCSensitive                    Boolean          True                   CSG
  276.      XmNtranslations                 XmCTranslations                 XtTranslations   dynamic                CSG
  277.      XmNwidth                        XmCWidth                        Dimension        dynamic                CSG
  278.      XmNx                            XmCPosition                     Position         0                      CSG
  279.      XmNy                            XmCPosition                     Position         0                      CSG
  280.  
  281.         CCCCaaaallllllllbbbbaaaacccckkkk IIIInnnnffffoooorrrrmmmmaaaattttiiiioooonnnn
  282.           A pointer to the following structure is passed to each
  283.           callback:
  284.  
  285.           ttttyyyyppppeeeeddddeeeeffff ssssttttrrrruuuucccctttt
  286.           {{{{
  287.             iiiinnnntttt      _r_e_a_s_o_n;;;;
  288.             XXXXEEEEvvvveeeennnntttt   * _e_v_e_n_t;;;;
  289.           }}}} XXXXmmmmAAAAnnnnyyyyCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt;;;;
  290.  
  291.  
  292.           _r_e_a_s_o_n Indicates why the callback was invoked.
  293.  
  294.           _e_v_e_n_t  Points to the XXXXEEEEvvvveeeennnntttt that triggered the callback or
  295.                  is NULL if this callback was not triggered due to an
  296.                  XXXXEEEEvvvveeeennnntttt.
  297.  
  298.  
  299.         TTTTrrrraaaannnnssssllllaaaattttiiiioooonnnnssss
  300.           XmCascadeButton includes translations from Primitive.
  301.           XmCascadeButton includes the menu traversal translations
  302.           from XmLabel.  These translations may not directly
  303.           correspond to a translation table.
  304.  
  305.           Note that altering translations in ####oooovvvveeeerrrrrrrriiiiddddeeee or ####aaaauuuuggggmmmmeeeennnntttt
  306.           mode is undefined.
  307.  
  308.           The translations for a CascadeButton in a MenuBar are listed
  309.           below.  These translations may not directly correspond to a
  310.           translation table.
  311.  
  312.           BBBBSSSSeeeelllleeeecccctttt PPPPrrrreeeessssssss:::: MMMMeeeennnnuuuuBBBBaaaarrrrSSSSeeeelllleeeecccctttt(((())))
  313.           BBBBSSSSeeeelllleeeecccctttt RRRReeeelllleeeeaaaasssseeee::::DDDDooooSSSSeeeelllleeeecccctttt(((())))
  314.           KKKKAAAAccccttttiiiivvvvaaaatttteeee::::     KKKKeeeeyyyySSSSeeeelllleeeecccctttt(((())))
  315.           KKKKSSSSeeeelllleeeecccctttt::::       KKKKeeeeyyyySSSSeeeelllleeeecccctttt(((())))
  316.           KKKKHHHHeeeellllpppp::::         HHHHeeeellllpppp(((())))
  317.           MMMMAAAAnnnnyyyy KKKKCCCCaaaannnncccceeeellll::::  CCCClllleeeeaaaannnnuuuuppppMMMMeeeennnnuuuuBBBBaaaarrrr(((())))
  318.  
  319.  
  320.           The translations for a CascadeButton in a PullDown or Popup
  321.           MenuPane are listed below.  In a Popup menu system, BBBBMMMMeeeennnnuuuu
  322.           also performs the BBBBSSSSeeeelllleeeecccctttt actions.  These translations may
  323.           not directly correspond to a translation table.
  324.  
  325.  
  326.  
  327.      Page 5                                          (printed 4/30/98)
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.      XXXXmmmmCCCCaaaassssccccaaaaddddeeeeBBBBuuuuttttttttoooonnnn((((3333XXXX))))       UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV       XXXXmmmmCCCCaaaassssccccaaaaddddeeeeBBBBuuuuttttttttoooonnnn((((3333XXXX))))
  335.  
  336.  
  337.  
  338.           BBBBSSSSeeeelllleeeecccctttt PPPPrrrreeeessssssss:::: SSSSttttaaaarrrrttttDDDDrrrraaaagggg(((())))
  339.           BBBBSSSSeeeelllleeeecccctttt RRRReeeelllleeeeaaaasssseeee::::DDDDooooSSSSeeeelllleeeecccctttt(((())))
  340.           KKKKAAAAccccttttiiiivvvvaaaatttteeee::::     KKKKeeeeyyyySSSSeeeelllleeeecccctttt(((())))
  341.           KKKKSSSSeeeelllleeeecccctttt::::       KKKKeeeeyyyySSSSeeeelllleeeecccctttt(((())))
  342.           KKKKHHHHeeeellllpppp::::         HHHHeeeellllpppp(((())))
  343.           MMMMAAAAnnnnyyyy KKKKCCCCaaaannnncccceeeellll::::  CCCClllleeeeaaaannnnuuuuppppMMMMeeeennnnuuuuBBBBaaaarrrr(((())))
  344.  
  345.  
  346.         AAAAccccttttiiiioooonnnn RRRRoooouuuuttttiiiinnnneeeessss
  347.           The XmCascadeButton action routines are described below:
  348.  
  349.  
  350.           CCCClllleeeeaaaannnnuuuuppppMMMMeeeennnnuuuuBBBBaaaarrrr(((()))):
  351.                     In a MenuBar, disarms the CascadeButton and the
  352.                     menu and, when the shell's keyboard focus policy
  353.                     is XXXXmmmmEEEEXXXXPPPPLLLLIIIICCCCTTTT, restores keyboard focus to the
  354.                     widget that had the focus before the menu was
  355.                     entered.
  356.  
  357.                     In a toplevel Pulldown MenuPane from a MenuBar,
  358.                     unposts the menu, disarms the MenuBar
  359.                     CascadeButton and the MenuBar, and, when the
  360.                     shell's keyboard focus policy is XXXXmmmmEEEEXXXXPPPPLLLLIIIICCCCTTTT,
  361.                     restores keyboard focus to the widget that had the
  362.                     focus before the MenuBar was entered.  In other
  363.                     Pulldown MenuPanes, unposts the menu.
  364.  
  365.                     In a Popup MenuPane, unposts the menu and, when
  366.                     the shell's keyboard focus policy is XXXXmmmmEEEEXXXXPPPPLLLLIIIICCCCTTTT,
  367.                     restores keyboard focus to the widget from which
  368.                     the menu was posted.
  369.  
  370.           DDDDooooSSSSeeeelllleeeecccctttt(((()))):
  371.                     Calls the callbacks in XXXXmmmmNNNNccccaaaassssccccaaaaddddiiiinnnnggggCCCCaaaallllllllbbbbaaaacccckkkk, posts
  372.                     the submenu attached to the CascadeButton and
  373.                     enables keyboard traversal within the menu.  If
  374.                     the CascadeButton does not have a submenu
  375.                     attached, calls the callbacks in
  376.                     XXXXmmmmNNNNaaaaccccttttiiiivvvvaaaatttteeeeCCCCaaaallllllllbbbbaaaacccckkkk, the CascadeButton is
  377.                     activated and all posted menus in the cascade are
  378.                     unposted.
  379.  
  380.           HHHHeeeellllpppp(((()))):   Unposts all menus in the menu hierarchy and, when
  381.                     the shell's keyboard focus policy is XXXXmmmmEEEEXXXXPPPPLLLLIIIICCCCTTTT,
  382.                     restores keyboard focus to the widget that had the
  383.                     focus before the menu system was entered.  Calls
  384.                     the callbacks for XXXXmmmmNNNNhhhheeeellllppppCCCCaaaallllllllbbbbaaaacccckkkk if any exist.
  385.                     If there are no help callbacks for this widget,
  386.                     this action calls the help callbacks for the
  387.                     nearest ancestor that has them.
  388.  
  389.           KKKKeeeeyyyySSSSeeeelllleeeecccctttt(((()))):
  390.  
  391.  
  392.  
  393.      Page 6                                          (printed 4/30/98)
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.      XXXXmmmmCCCCaaaassssccccaaaaddddeeeeBBBBuuuuttttttttoooonnnn((((3333XXXX))))       UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV       XXXXmmmmCCCCaaaassssccccaaaaddddeeeeBBBBuuuuttttttttoooonnnn((((3333XXXX))))
  401.  
  402.  
  403.  
  404.                     Calls the callbacks in XXXXmmmmNNNNccccaaaassssccccaaaaddddiiiinnnnggggCCCCaaaallllllllbbbbaaaacccckkkk, and
  405.                     posts the submenu attached to the CascadeButton if
  406.                     keyboard traversal is enabled in the menu.  If the
  407.                     CascadeButton does not have a submenu attached,
  408.                     calls the callbacks in XXXXmmmmNNNNaaaaccccttttiiiivvvvaaaatttteeeeCCCCaaaallllllllbbbbaaaacccckkkk, the
  409.                     CascadeButton is activated and all posted menus in
  410.                     the cascade are unposted.
  411.  
  412.           MMMMeeeennnnuuuuBBBBaaaarrrrSSSSeeeelllleeeecccctttt(((()))):
  413.                     Unposts any menus posted by the parent menu.  Arms
  414.                     both the CascadeButton and the MenuBar, posts the
  415.                     associated submenu, and enables mouse traversal.
  416.                     If the menu is already active, this event disables
  417.                     keyboard traversal for the menu and returns the
  418.                     menu to mouse traversal mode.
  419.  
  420.           SSSSttttaaaarrrrttttDDDDrrrraaaagggg(((()))):
  421.                     Arms the CascadeButton, posts the associated
  422.                     submenu, and enables mouse traversal.  If the menu
  423.                     is already active, this event disables keyboard
  424.                     traversal for the menu and returns the menu to
  425.                     mouse traversal mode.
  426.  
  427.  
  428.         AAAAddddddddiiiittttiiiioooonnnnaaaallll BBBBeeeehhhhaaaavvvviiiioooorrrr
  429.           Posting a submenu calls the XXXXmmmmNNNNccccaaaassssccccaaaaddddiiiinnnnggggCCCCaaaallllllllbbbbaaaacccckkkk callbacks.
  430.           This widget has the additional behavior described below:
  431.  
  432.  
  433.           <<<<EEEEnnnntttteeeerrrrWWWWiiiinnnnddddoooowwww>>>>:
  434.                     If keyboard traversal is enabled does nothing.
  435.                     Otherwise, in a MenuBar that is armed, unposts any
  436.                     MenuPanes associated with another MenuBar entry,
  437.                     arms the CascadeButton, and posts the associated
  438.                     submenu.  In other menus, arms the CascadeButton
  439.                     and posts the associated submenu after the delay
  440.                     specified by XXXXmmmmNNNNmmmmaaaappppppppiiiinnnnggggDDDDeeeellllaaaayyyy.
  441.  
  442.           <<<<LLLLeeeeaaaavvvveeeeWWWWiiiinnnnddddoooowwww>>>>:
  443.                     If keyboard traversal is enabled does nothing.
  444.                     Otherwise, in a MenuBar that is armed, disarms the
  445.                     CascadeButton if the submenu associated with the
  446.                     CascadeButton is not currently posted or if there
  447.                     is no submenu associated with the CascadeButton.
  448.  
  449.                     In other menus, if the pointer moves anywhere
  450.                     except into a submenu associated with the
  451.                     CascadeButton, the CascadeButton is disarmed and
  452.                     its submenu is unposted.
  453.  
  454.  
  455.         VVVViiiirrrrttttuuuuaaaallll BBBBiiiinnnnddddiiiinnnnggggssss
  456.  
  457.  
  458.  
  459.      PPPPaaaaggggeeee 7777                                          ((((pppprrrriiiinnnntttteeeedddd 4444////33330000////99998888))))
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.      XXXXmmmmCCCCaaaassssccccaaaaddddeeeeBBBBuuuuttttttttoooonnnn((((3333XXXX))))       UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV       XXXXmmmmCCCCaaaassssccccaaaaddddeeeeBBBBuuuuttttttttoooonnnn((((3333XXXX))))
  467.  
  468.  
  469.  
  470.           The bindings for virtual keys are vendor specific.  For
  471.           information about bindings for virtual buttons and keys, see
  472.           VVVViiiirrrrttttuuuuaaaallllBBBBiiiinnnnddddiiiinnnnggggssss((((3333XXXX)))).
  473.  
  474.      RRRREEEELLLLAAAATTTTEEEEDDDD IIIINNNNFFFFOOOORRRRMMMMAAAATTTTIIIIOOOONNNN
  475.           CCCCoooorrrreeee((((3333XXXX)))), XXXXmmmmCCCCaaaassssccccaaaaddddeeeeBBBBuuuuttttttttoooonnnnHHHHiiiigggghhhhlllliiiigggghhhhtttt((((3333XXXX)))),
  476.           XXXXmmmmCCCCrrrreeeeaaaatttteeeeCCCCaaaassssccccaaaaddddeeeeBBBBuuuuttttttttoooonnnn((((3333XXXX)))),,,,XXXXmmmmCCCCrrrreeeeaaaatttteeeeMMMMeeeennnnuuuuBBBBaaaarrrr((((3333XXXX)))),
  477.           XXXXmmmmCCCCrrrreeeeaaaatttteeeePPPPuuuullllllllddddoooowwwwnnnnMMMMeeeennnnuuuu((((3333XXXX)))), XXXXmmmmCCCCrrrreeeeaaaatttteeeePPPPooooppppuuuuppppMMMMeeeennnnuuuu((((3333XXXX)))),
  478.           XXXXmmmmLLLLaaaabbbbeeeellll((((3333XXXX)))), XXXXmmmmPPPPrrrriiiimmmmiiiittttiiiivvvveeee((((3333XXXX)))), and XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))).
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.      Page 8                                          (printed 4/30/98)
  526.  
  527.  
  528.  
  529.